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OS— 9 MECTINS: 

Meetings are held at 7:30 p.m., the second Thursday of each month in room 109 at 

Sehome High School. 

BENEFITS TO MEMBERS : 

As a participating member of our new Bellingham OS9 Users Group you enjoy many 

benefits: 

1. Newsletter 

2. 0S9 Bulletins 

3. t Public Domain Library 

4. Technical help 

5. Lectures and demonstrations 

6. Periodic group purchases 

7. Membership List 

8. Access to GIMIX Level-Ill 0S9 

T ^TFTT .T => WTMXl' I 'htlS^ 

Our group needs editorial volunteers. If you can contribute with information or 
helpful experiences of your own, please contact Rodger Alexander. The health of 
our newsletter depends on contributions made by many members of our group. 

nJ THIS ISSUE: 

i MEG OF RAM Review of the new 1 Meg Ram Package by CRC/Disto 

FCC LETTER CAMPAIGN If you use a modem, READ THIS! 

0S9 UPGRADE? Latest from the author, Kev. Darling 

HOMEWORK Using macros to EDIT "scriptf i les M plus ATTRibutes 

PC TO COCO Real world application using RS-232 null modem 

WTNDOWMAKER Shell+ window application scriptf ile to make Windows 

RBF & SCF DRIVERS Understanding 0S9 Random and Sequential File Managers 

SUBSCRIPTION INFORMATION : 

Newsletters are available free to those in attendance at the monthly meetings. 
If you would like to receive the newsletter in advance by mail a subscription 
rate of $3 for 6 monthly issues or $6 for 12 monthly issues is available. 

Contact: ' Rodger Alexander 

3404 Illinois Lane 
Bellingham, WA 98226 
(206) 734-5806 
Delphi : "SALZARD 



RfC of Ram 



A little week-e^rly birthday presen tsliowed 
up at my doorthis Saturday (3/3) — my 1 
Meg RAM upgrade kit from CRC/Disto, 
I*ve been too busy upgrading some pro- 
gi-ajjjs to do anymore than look it ovsr, but 
here s wha t I've seen so far: There are three 
hardware pieces: the centipede gadget you 
solder straddling vour 6S09 CPU, a garden - 
variety 512K jRAM upgrade board (with 
socketed 120 ns chips crammed in to a really 
compact layout), and an equally tuiy all- 
soldered board of TT1T logic that imple- 
ments the 1 Megswitcliing, About a dozen 
chips on that last item, looks very profes- 
sional. A fourth hardware piece is a big 
plug-in DC power supply to tike the load 
off yow poor little Coco3 supply. Included 
is an OS9 disk oflPatcli files (and IPatch!) 
to zap GrfDrv and VDGInt into under- 
standing 1 Meg, Would you believe the 
GrfDrv patch also includes all of Kevin 
Darlings speedups. Good, since you must 
start from "vii'gin" Tandy modules to 
ipatcli, I miglit not install the beast until 
after RahibowFest but I'm really looking 
forward to editing and compiling C while 
UmuseJ is running. Heck, lean even keep 
a grafix window open all the time,,, might 
even dust off MultiVue, (Just to test the 
upgrade, j^ou understand), Whenmu boot 
up with the upgrade, }*ou have to execute a 
little machine-code rile "mega " to enable 
the 1 Meg. Tliis is so you can run certain 
games (King's Guest, etc) in 512K; these 
games tweedle the GIME/DAT reg? di- 
rectly (slap/ slap the wrxsf /) and so have to 
nuiin "native "mode. There s also a restric- 
tion that one s>ideo window can 'tstraddle- 
the boimdary between hiandlo S12halves. 
Dunno whether the patched GrfDrv and 
VDGInt "know" not to do that, or Tony 



justessumes that your screens, which OS9 
allocates from top of RAM downwards, 
with 't take up over 512K That } s 16 screens 
of 640x4 or 320x16 colors, so may be safe 
most of the time. 



F.C.C. 



Once again the FCC rears it's head in an 
attempt to wring more money out of us 
modern users: 

BEWARE!!! 

A new regulation that the FCC is quietly 
working on will directly affect you as the 
user of a computer and modem. The FCC 
proposes that users of modems should pay 
extra charges for use of the public tele- 
phone network which carry their data. 

In addition, computer network services 
such as CompuServ, Tymnet, & Telenet 
would also be charged as much as $6,00 per 
hour per user for use of the public tele- 
phone network. These charges would very 
likely be passed on to the subscribers. 

The money is to be collected and given to 
the telephone company in an effort to raise 
funds lost to deregulation. Jim Eason of 
KGO newstalk radio (San Francisco, Ca) 
commented on the proposal during his af- 
ternoon radio program during which, he 
said he learned of the new regulation in an 
article in the New 7 York Times. 

Jim took the time to gather the addresses 
which are given below. What you should 
do: First, find three or more BBS systems 
which are not carrying this message and 



J 



upload this text. Then, print three copies of 
the letter which follows (or write your own) 
and send a signed copy to the three ad- 
dresses. It is important that you act now. 
The bureaucrats already have it in there 
mind that modem users should subsidize 
the phone company and are now listening 
to public comment. 

Please stand up and make it clear that we 
will not stand for any government restric- 
tion on the free exchange of information. 

The three addresses to wxite to: (a letter to 
send follows) 

Chairman of the FCC 
1919 M Street N.W. 
Washington, D.C. 20554 

Chairman, 

Senate Communication Subcommittee 

SH-227 Hart Building 
Washington, D.C. 20510 

Chairman, 

HouseTelecommunicationSubcomiruttee 

B-331 Ravburn 

Building," Washington, D.C. 20515 




Dear Sir, 

Please allow me to express my displeasure 
with the FCC proposal which would au- 
thorize a surcharge for the use of modems 
on the telephone network, This regulation 
is nothing less than an attempt to restrict 
the free exchange of information among 
the growing number of computer users. 
Calls placed using modems require no 
special telephone company equipment 
and users of modems pay the phone com- 
pany for use of the network in the form of 
a mon tlily bill, In short, a modem call is the 
same as a mice call and therefore should 
not be subject to any additional regulation, 
(or something similai') 



Suffice to say that it was an o**icial up- 
grade , that it took a long time to finish, and 
then (as everyone here should know quite 
well by now) Tandy stopped buying CoCo 
software. That left things in limbo. It 
means weird deals must be worked out all 
around. This takes time, patience, and 
diplomacy. They're convinced that the 
parties involved will figure out something 
tho, and that's why the interest must be 
kept simmering (in case they DO end up 
needing a letter campaign - heh heh). 
Those who don't want to hear about it until 
it's officially out, should just close their 
eyes <£mile>. 

What's improved in it? That was the sub- 
ject of many rnsgs on the major forums. 
Too much to cover. Basically: bugs gone, 
interrupts fixed in software, speed im- 
proved, CC3io broken into additional 
modules JoyDrv, KeyDrv, SndDrv (thus 
allowing serial mice drivers, new keybd 
drivers, etc), new calls for sliders and but- 
tons, and some other junk. The list is pretty 
long. It's very solid. 



EDITOR'S NOTE: In the April issue of 
the Rainbow, Dale Pucket in his "Kissable 
OS9" article, printed his old familar "FI- 
NANCE" program modified to take advan- 
tage of the new GFX2 module contained in 
the not yet released QS9 Level-H upgrade. 

It was my fault. He'd been dying to write 
something about it for a long time; and 
altho Rainbow had misgivings about print- 
ing the article, I told them there was a good 
chance the upgrade would be available by 



the time the magazine came out... or if it 
wasn't, then people would still love to see 
and study the code anyway, judging from 
all the questions on networks. Seemed like 
it would be a special gift similar to the fast 
grfdrv patches. 

Obviously I was wrong <wry smile>, 

It's very clear now that we should never 
have mentioned the upgrade. Another les- 
son learned the hard way, eh? 




QUICK REVIEW : So far we have used 
several OS9 commands to create a directory 
(MAKDIR) and then transferred files to 
our new directory using the COPY utility. 
Using the BUILD utility we wrote a text 
file and last month we used the EDIT 
utility to make modifications to our previ- 
ous text files . By now you should be getting 
pretty swift at j\imping around between 
directories. 

LESSON #3: 

The i( Startup " file is a procedure file (also 
known as a ^ script file" [also known as a 
"batch file" to MS-Dos users]). B^caUyitsatext 
file containing a list of system cr DOS ocaiTmands 
thafcwu want the rorri^ A simple 

"Startup" file might look like this: 

display Oc 
setirne<#enxL 
list /dd/sys^riotd 

"Display", "Setime'\ "List" are three ex- 
ecutable system commands that you could 
just as well have entered from the com- 
puter and get the same results, but by 



putting them in a text file the computer 
1 'reads ' ' the instructions and executes them 
without you having to type in the same 
instruction everytime you boot up OS9. 

OK! Now lets get to work and create our own 
startup file using the BLTUDardEDn'iitilitlfis: 

1. Enter: BUILD startup 

2. At the "? n prompts, enter the f ollow- 
ing listing: 

Display lb 33 01 lb 32 00 lb 34 01 C 

List /dO/sys/motd 

Setime </term 

List /dO/sys/initialize 

Load /dO/cmds/utilities 

Iniz w7 

Shell i-/w7& 

Press [ENTER] by itself to save your 
"startup" file and end the BUILD pro- 
gram, returning you to the OS9 shell. 

NOTE: Tomakeour * 'star tup "file work we 
are also going to have to create a "MOTD" 
(Message Of The Day) in our SYS direc- 
tory, an "INITIALIZE" (initializing or 
"loading files" sign) in otir SYS directory, 
and merge some useful command utilities 
that we would like to have loaded into 
memory. 

3. Enter: CHD SYSjDIR 

NOTE: You are changing the default data 
directory from root directory (/d0) to the 
SYS (/dO/SYS) directory. The semicolon 
(;) serves as a deliminator so that you can 
append a second command to the first. In 
this case the second command is DIR. 

4. Enter: BUILD motd 

5 . At the " ? " prompts , enter the follow- 
ing listing: 

Enter: 24 spaces, then 33 "* M (stars/asteriks) 



Enter: 19spaces, then 7 "* ", then 29 spaces, 

then?"*" 
Enter: 17 spaces, then 7 "*", then 5 spans, 

then "WELCOME TO OS9 LEkELr 

II" then 5 spaces, then 7 "* fi 
Enter:17spaces,then7"*'\then5 spaces, 

then 23 "=", then Sspaces, then 7"*" 
Enter: 19 spaces, then 7 "* n , then 29spaces, 

then 7"*" 
Enter: 24 spaces, then 33 "* M 
Enter: [ENTER] (Press the ENTER key) 

NOTE: The above entry assumes an 80 
column screen. If your system comes up on 
a 40 column screen, replace the first num- 
ber entry on each line by 1/2 (24/2 - 12, 18/ 
2 = 9 ? etc) 

6. Enter: BUILD initialize 

7. At the "? ' ' prompts, enter the follow- 
ing listing: 

Enter: 1 space 

Enter: 1 space 

Enter: 1 space 

Enter: 1 space 

Enter: 1 space 

Enter: 1 space 

Enter: 29 spaces, then "INITIAL- 

I Z I N G" (space between each ltr.) 

Enter: 1 space 

Enter: 1 space 

Enter: 1 space 

Enter: [ENTER] (Press Enter key) 

NOTE: Replace 29 spaces with only 9 if 
using 40 column screen. 

8. CHD /DO/CMDS 

9 . Enter : MERGE dir mdir copy del list 
free echo futilities 

NOTE: When OS9 creates a file, it always 
assumes that it is a "data file". But our 
newly created utilities file is an "executable 
file" located in the CMDS directory, but 
OS9 still thinks it is a "data file" and will not 



load or execute the file until we change the 
file attributes codes. Just to prove my point, 
try loding our merged utilities file: 

Enter: LOAD utilities 

OS9 should respond wth a #214 Error (No 
permission). You cannot load a "data fUe", 

Enter: ATTR utilites 

OS9 should respond with " — r-wr". The 
"R"s tell OS9 that this file may be "read" and 
the "W" tells OS9 that this file may be 
written to, but an "E" must exist in this 
attribute code in order for OS9 to under- 
stand that utilities is an executable file. 
So...... 



10. 



Enter: ATTR utilities e 

(OS9 should respond with " — rewr") 



I didn't want to get into file attributes, but 
as you can see, OS9 made me do it! 

We now have all that is required by our 
"startup" file, however, our "startup" file 
assumes that we are booting up on drive 0. 
If we were using a hard drive, the startup 
file would fail to function due to the "/dQ" 
references. We need to change the ( 7d0' ' to 
"/dd" (Default Directory). Remember last 
month when we used the "C" (Change 
command) to modify our original HOME- 
WORK text file? The macro capability of 
the EDIT command can make these 
changes more easily than editing each line 
by hand. 

11. Enter: CHD /DO 

12. Enter: BUILD modify 

13. At the " ? " prompts , enter the follow- 
ing listing: 



./d0./dd. 

q 



[ENTER] (Press the ENTER key) 

Thatsour macao fQe. AbriC6ttoosinT|de!Iri1hefitst 
line the program wQl be instriKlbigtheEDrrortD 
"Chang* "*" (an) occuranoes cf 7d0" and rejtfaoe 
with "Aid". 

OK, Lets do it 

14 Enter: EDrTstarti^<rnod3fy 

(OS9 should list out our startup file with the 
nevv changes..... Well, did it?) 

CONCLUSION; Now re-boot the computer, 

and ifev^1hir^w^talri^t,y^ 

fancy looking OS9 Bbot 

QUESTION: What does the DISPLAYcciTimand 
in our startup file do? 



PC to CoCo 
Connection 

by Craig DuBois 



Last week I undertook a new project of de- 
bugging a processor controlled system at 
work. The Audichron IIS takes commands 
from a telephone office and translates them 
into pre-programmed custom messages: 
"The number you have dialed, xxx-xxxx, 
has been changed to yyy-yyyy M , etc, After 
lengthy phone conversations with the 
manufacturer and other ' 'experts M , I deter- 
mined a fresh software load was needed. 



A Toshiba Tl 100 laptop PC was sent to me 
along with several 3 1/2 inch diskettes. 
With an "expert" on the phone wedged 
between my shoulder and ear and the PC 
plugged into the Audichron, I proceeded to 
load away. After several attempts, the 
mission was successful. 

"But what did I do, and how did it work?" 



I asked myself. To answer, I took the 
Toshiba home where I could play in a non- 
destructive environment. I found the 
RS232 cable on the Toshiba matched the 
Deluxe RS-232 Program Pack jack sticking 
out of slot 1 of my CoCo multi pack. Roger 
Alexander suggested the null modem 
which proved to be the finishing touch to 
the PC-to-CoCo connection. I loaded 
"DeskMate telecom" in the CoCo and 
' 'Cross-talk* ' in the PC. To my own amaze- 
ment, the two got along quite nicely, thank 
you. I even swapped a few data files back 
and fourth. 

So, next time the Audichron decides to get 
finnicky, it will get a data transfusion via 
CoCo OS-9. The lone Toshiba can stay in 
the hands of some "expert" far far away. 



RS-232 



25-Pin 



9-Pin 



, 13 *. 54331 

25 14 Q R •? ft 



1 CARRIER DETECT- 

2 RECEIVE DATA— 

3 SEND DATA 



■8 
■3 

_2 

4 -DATA TEEM READY- 20 

5 GROUND 7 

6 DATA SET READY — 6 

7 —REQUEST TO SEND — 4 

S CLEAR TO SEND 5 

9 RING INDICATOR — 22 

This is a comparison of the 25 pin serial jack 
on the CoCo P.S-232 program pak and the 
9 pin serial jack on the Toshiba T-l 1 00 P.C. 
With the above pin-out information, a 
cable- can be constructed with a 25-pin plug 
on one end and a 9-pin on the other end. 
With such a "converter" cable, the CoCo 
can be connected to a 9-pin P.C. serai jack. 



Windowmaker 

Shell + scriptfile 



WINDOWMAKER is a "scriptfile" just 
like your Startup file for OS9 Level-II with 
Sheil+ , WINDOWMAKER prompts the 
user for the Window Number and then 
prompts for the "type" of window desired. 
Notice the "VAR'iable and "Prompt" 
functions. Shell+ is avail-able on DELPHI, 
COMPUSERV, BASE ACCUMULA- 
TOR (455-3410), BBQ-RiBBS (676-5787), 
and DATA WAREHOUSE' (509-325- 
6787). 

els 

echo 

echo WMAKER 

echo window maker with typeset 

echo by Ken Heist 

merge /h0/sys/stdpats_4 /hO/sys/stdptrs 

/hO/sys/stdfonts >/w 
echo 
echo 

echo TYPES: 

echo 1 40x24 text 8c 2Kmem. 
echo 2 80x24 text 8c 4Kmem. 
echo 5 640x192 graphic 2c 16Kmem. 
echo 6 320x192 graphic 4c 16Kmem. 
echo 7 640x192 graphic 4c 32Kmem. 
echo 8 320x192 graphic 16c 32Kmem. 
echo 

Prompt Choose Window (1-15): 
var.O 

Prompt What Type: 
var.l 
if <7ol=l 

iniz \\*7oQ 

display lb 20 1 28 18 1 1 >/w?b0 

display lb 31 1 IS lb 32 lb 33 1 lb 34 1 
>/w%0 

shell i=/w<5S>0& 

echo Typel 40x24 Text 8c 2Kmem. 

else 



if <7ol=2 
iniz w*7o0 

display lb 20 2 50 IS 1 1 >/w<7*0 
display lb 31 1 18 lb 32 lb 33 1 lb 34 1 

>/w<7o0 
shell i=/w<7o0& 

echo Type2 80x24 Text Sc 4Kmem. 
>/w<7o0 
else 
if <Yol=5 

iniz w*5fe0 

display lb 20 5 50 18 1 2 >/w%0 

display lb 3a c8 01 >/w%0 

display lb 32 lb 33 1 lb 34 2 >/w<7o0 

shell i=/w<7o0& 

echo Type5 640x192 Graphic 2c 
16Kmem. >/w7b0 
else 
if %1=6 

iniz w*7&0 

display lb 20 6 28 18 1 2 >/w<7o0 

display lb 3a c8 01 >/w%0 

display lb 32 lb 33 1 lb 34 2 >/w<7o0 

shell i=/w%0& 

echo Type6 320x192 Graphic 
4c 16Kmem, >/w<7<?0 
else 
if %1=7 

iniz w*7o0 

display lb 20 7 50 18 1 2 >/w<7o0 

display lb 3a c8 01 >/w%0 

display lb 32 lb 33 1 lb 34 1 >fr/7o0 

shell i=/w<7o0& 

echo Type7 640x192 Graphic 
4c 32Kmem. >/w%0 
else 
if %1=8 

iniz w%0 

display lb 20 8 28 18 1 2 >/w%0 

display lb 3a c8 01 >/w%0 

display lb 32 lb 33 1 lb 34 2 >/\v<Vo0 

shell i=/w%0& 

echo TypeS 320x192 Graphic 
16c 32Kmem. >/w9k0 
else 

endif 
clrif 



RBF & SCF filters 

by Mike Pleas 



OS9 LEVEL-II Basics: 

When first starting out in OS9 it's some- 
times very difficult to grasp the subtler 
basics making up this operating system. 
Unless you've had experience in program- 
ming in UNIX or MS-DOS, OS9 can be a 
very bewildering system to cut your teeth 
on, as I did. I'm going to attempt to show 
you the basic inner workings of OS9 and 
maybe clarify some of the mote difficult 
nuances of our system. 

First off, even though the Coco 3 has been 
vastly improved, ie. better graphics and 
5I2k memory; it still uses the 6809 cpu. 
What this means is that it can only use 64k 
at a time. The wav Tandv 20 1 around this 
was to add a Memory Management Unit 
(MMU). This piece of hardware works in 
conjunction with the CPU to pull in and 
put back from high memory &k blocks. In 
other words the active part of memory, the 
"work space", is constantly pulling in and 
pushing out information from the rela- 
tively inactive parts of memory. Think of it 
as a subway station where the cars are con- 
stantly disembarking and embarking pas- 
sengers. But this station has limited space 
so if too many attempt to get off. then an 
equal or greater number must be trans- 
ported away. 

When you first boot up, OS9 erases all of 
the Radio Shack Basic rom routines. It then 
goes through it's first pass in which it sets 
up spaces, in memory, for the various 
modules needed to operate. Modules, in a 
loose s^nse, can be consideredas rom rou- 
tines, 



In the second pass, OS9 then sets up the 
parameters necessary to communicate with 
the various devices. More on that later. 

Now we get to a very important aspect in 
system theory that we tend to ignore, 
Tables. In order for OS9 to run it must have 
tables to reference to. MMU, for instance, 
must be able to know where a particular 
module is located outside of the work space . 
Another example is the information the 
system needs to operate and communicate 
with the devices. The list of tables that OS9 
uses is very long and beyond the scope of 
this paper. 

A brief note to you more advanced pro- 
grammers. One common misconception is 
that OS9 always looks up parameters for 
various routines and devices in the descrip- 
tor modules. This is too time consuming 
and cumbersome. So instead, when OS 9 
first boots up, Os9p2 passes these parame- 
ters to tables in the path descriptor sections 
within the various device or system manag- 
ers. For the most part, the discriptor mod- 
ules are only needed as an occasional refer- 
ence, or for a warm reset. This is why de- 
bugging a descriptor module will show no 
change after demoding, xmoding, tmod- 
ing, etc. 

Under no circumstances should any table 
be altered directly. This can lead to disas- 
trous results. I tried messing with the 
MMU addresses and succeeded to lock up 

I the computer. I can imagine doing perma- 
nent damage to your files if you fool 

i with disk drive tables. 

j Back to the basics. The modules found in 
I the boot file fall into basic catagories. I've 
I outlined them in block form in the diagram 

below. We're onlv concerned with two, 

RBF and SCF. 

RBF (Random Block File)- This includes 



all the disk drives. In brief, the way it works 
is that when you or the system requests to 
write to or read any part of a disk, RBFlooks 
up in a table (usually on the disk itself) the 
information needed. The random block 
part means any part of a disk can be ac- 
cessed without going through every part 
before it to get to it. 

SCF (Sequential Character File)- This 
covers just about every other peripheral 
used- from the screen, to modems, to the 
speech sound pack. Another term you 
could use is Asynchronous Serial or Paral- 
lel Interface Manager, Ehit we'll stick with 
SCF, 



SCF generally uses a modified RS232 pro- 
tocal to communicate with it's devices. 
Thus all information is sent and received in 
a sequential manner. For example, the 
screen is sent a series of characters to fill the 
screen from left to right and from top to 
bottom and then started over again when a 
change is made. 

That just about wraps up this article. Next 
month I'll get into some of the commands 
that you can use to modify some of the 
modules mentioned above. 



mTom Cat 

by Kevin Darling 



Don't read this if you don't like to hear 
about things before they are available 
<smile>!!! It'll be another month before 
production begins, I think. 

Here's a highly edited version (drastically 
shortened) of the announcement that FHL 
just posted to CIS on his version of the 
KM A [some notes are mine]: 

;i The TC9 TOMCAT (TM) is a major 
improvement over the CoCo 3." 
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* Is over 25°/o faster! [6309 boosted at times 

to double speed] 

* Uses a PC compatible keyboard. 

* Has two 'real' serial ports. 

* Supports a serial mouse, 

* Has a parallel printer port. 

* 512K on board RAM or it can use a CoCo 

3 512K memory upgrade. 

* Can be upgraded to 1 megabyte with the 

Disto 1 Meg upgrade [plug in]. 

* Has S bit D to A and A to D. [sound/ 

joystick]. 

* Supports an internal speaker. 

* Has the standard CoCo bus so that CoCo 

cartridges can be used. 

* Board can be powered by any PC power 

supply. 

* Will work with most, if not all OS9 

software. 

* Will have RSDOS compatibility thru 

3rd party vendors. 

* Is K-Bus compatible [bus not required 

for TC9 operation]" 

FHL goes on to envision the possibility of 
several TC9's in a K-bus along with 68000- 
68030 cpus running alongside, with either 
perhaps using the other cpus for I/O proc- 
essing in some cases. 



